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Problem Reporting 


Preface 

This document provides the foil owing information: 

• features 

• installation information 

• related documentation 

• problem descriptions and fixes and known limitations 

Note: The software code printed in the release notes title indicates the 
software product version at the time of release. Some product and 
operating system changes do not require changes to documentation; 
therefore, do not expect a one-to-one correspondence between these 
changes and release notes updates. 

Latest printing: August 1998 

This document resides online in the file 

/opt/aCC/newconfig/RelNotes/ACXX.release.notes. You can print the 
online copy by using an ip command I ike the foil owing: 

lp — dpri ntQ"_name /opt/aCC/newconfig/RelNotes/ACXX. release, notes 

If you have any problems with the software or documentation, please 
contact your local Hewlett-Packard Sales Office or Customer Service 
Center. 
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Features 

New and Changed Features 


Features 


This chapter summarizes the features included in this version of the HP 
aC++compiler. Features introduced in prior release versions are also 
listed and grouped by the compiler version number. 

The compiler supports Final Draft I nternational Standard. 


New and Changed Features 

New features in H P aC++version A.01.15 are listed below. They apply to 
HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.). 

• TheHP aC-H-OnlineProgrammer’sGuidehas been updated from HP 
CDE format to HTML format viewable with your HTML browser. For 
details and access instructions, see Chapter 3 of these release notes 
under Online Documentation. 

• Standards based features include the foil owing: 

• covariant return types (except for covariant return types with 
multiply inheriting types) 

• Koenig lookup 

Note: You must specify the-Wc,-koenig_lookup,on option. 

• .The-I-header file option invokes view-pathing. Thisoption 
overrides the default-I <directory> option header file search path. 

• Additional options for verbose compile and link information: 

• -Fdryrun - Requests compiler subprocess information without 
runni ng the subprocesses. 

• -Ftime - Requests subprocess execution times. 

• -V - Requests the current compiler and linker version numbers. 


Chapter 1 
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Features 

Version A.01.07 Features 


• -+M [d] and 4m[d] options to output the header files upon which your 
source code depends i n a format accepted by the make(l) command. 

• -fWe option allows you to selectively interpret a warning or future 
error as an error. 

• The_HP_aCC predefined macro identifies the H P aC++compiler. 

• At this release, the -Finline-level option defaults to 1. Intheprior 
versions, A.01.09, A.01.12, A.03.05, A.03.10, the default was 0, no 
inlining was done (the same effect as the +d option). 

This change was made based on customer feedback regarding object 
file size and runtime performance. 


Version A.01.07 Features 

New features in H P aC++version A.01.15 are listed below. They apply to 
HP-UX 10.10 and 10.20 operating systems. 

The HP aC-H-OnlineProgrammer's Guidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.). 

• The aC-H-default template instantiation mechanism has changed to 
compile-time instantiation (CTTI). For source code containing 
templates, the new default may result in faster compile-time 
processing. 

The previous default behavior remains available by specifying the 
+inst_auto command-line option when compiling and linking. If you 
provide archive or shared libraries for distribution, you may want to 
use +inst_auto to insure consistent behavior between each 
distribution of your libraries. 

Also, if you provide either archive or shared library products, and 
your customers need to use the prior tempi ate instantiation default in 
their builds, you must compile your libraries by using the +inst_auto 
option. 

Refer to the H P aC-H-Online Programmer’s Guide and to the online 
technical paper, Using Templates in HP aC++, for details about 
template instantiation and migration. For access instructions, see 
Chapter 3 of these release notes under Online Documentation.. 
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Features 

Version A.01.04 Features 


• Member templates are supported, including those in pre-compiled 
headers. 

• U pdated versi ons of the Rogue Wave Standard C ++ L i brary (versi on 
1.2.1) and theTools.h-H-Foundation Class Library (version 7.0.6) are 
provided. HTML documentation for these libraries is also updated; 
see Chapter 3 of these release notes under Online Documentation. 

• The HP aC-H-OnlineProgrammer's Guidehas been updated, 
including additional migration and template information. For access 
instructions, see Chapter 3 of these release notes under Online 
Documentati on. 

• The technical paper, Using Templates in HP aC++, has been updated 
to describe the new default, compile-time template mechanism and 
additional information about template libraries. For access 
instructions, see Chapter 3 of these release notes under Online 
Documentati on. 


Version A.01.04 Features 

Features introduced in the prior release, H P aC-H-versi on A.01.04 are 
listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

TheHP aC-H-OnlineProgrammer'sGuidecontainsfull documentation. 
(See Chapter 3 of these release notes for access instructions.) 

• -FESsfc — option to replace millicodecalls with inline code when 
performing simple fundi on pointer comparisons. 

• -Finlinejevel — option tocontrol how C-H-inlining hints influence H P 
aC++. 

• 4u — option to allow pointers to access non-natively aligned data. 
This option alters the way that the compiler accesses dereferenced 
data. Use of this option may reduce the efficiency of generated code. 

• -+W — option to seledively suppress warning messages. 

• Support for new style casts as defined in the proposed C++standard. 
The keywords const_cast, reinterpret_cast, and static_cast are 
supported. 


Chapter 1 
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Features 

Version A.01.00 Features 


• Partial support for the namespace and using keywords. User 
namespaces are supported. Standard C++Library components not in 
namespace std:: are not supported. Koenig lookup is not supported. 

• Support for class template partial specializations. 

• Extensiveonlinedocumentation is provided, including the first 
edition of the technical document, Using Templates in HP aC++. 
Refer to Chapter 3 of these release notes for details. 

• H P aC++now supports level 4 optimization. The -+04 compile-line 
option is supported. 

• H P aC++now supports profile-based optimization. The compile-line 
options -Fdfname, +1, +P and +pgmname are supported. 


Version A.01.00 Features 

Features introduced in the prior release, HP aC-H-version A.01.00, are 

listed below. They apply to HP-UX 10.10 and 10.20 operating systems. 

The HP aC-H-OnlineProgrammer's Guidecontainsfull documentation. 

(See Chapter 3 of these release notes for access instructions.) 

• I mproved error messages allow you to quickly isolate problems in 
your code. 

• Pre-compiled header files help you speed development substantially. 
Use them to reduce compilation time and object file size. 

• An automatic template instantiation mechanism is provided. (Note, 
as of H P a C++ version A.01.05, this mechanism is no longer the 
default, although it is available by specifying the +inst_auto 
command-line option.) 

• Explicit template instantiation (defined by the draft standard) is 
supported. 

• Application thread-safe exception handling in shared libraries is 
supported. 

• I nline functions are aggressively inlined. 

• Standards based features include the foil owing: 
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Features 

Version A.01.00 Features 


• keywords: bool, dynamic_cast, explicit, mutable, typeid, typename, 
volatile, wchar_t 

• class: typejnfo 

• explicit template instantiation 

• overloading new and delete for arrays 

• standard exception classes 

• The following libraries are provided: 

• Rogue Wave Standard C++Library Version 1.2.0, includes STL 
(updated at HP aC++Version A.01.07 to library version 1.2.1) 

• Rogue Wave Tool s.h++Version 7.0.2 Foundation Class Library 
(updated at H P aC++Version A.01.07 to library version 7.0.6) 

• cfront compatible Iostream Library 

• Standard Components Library (obsolete) 

• Extensiveonlinedocumentation is provided. Refer to Chapter 3 of 
these release notes. 

• +DA designations for PA-RI SC 2.0 model and processor numbers —to 
generate code for the PA-RI SC 2.0 systems. The -l-DAportable option 
will generate code compatible across PA-RISC 1.1 and 2.0 
workstations and servers. 

Default architecture object codegeneration is now determined 
automatically for all systems as that of the machine on which you 
compile. 

• +DS designations for PA-RISC 2.0 model and processor numbers--to 
perform instruction scheduling tuned for PA-RI SC 2.0 systems. 

Default instruction scheduling is now determined automatically for 
all systems as that of the machine on which you compile, or on the 
setting of +DA, if it is specified. 

• option -I:<Ji brary> — to support the Id feature. 

• +ESfic option -- to replace millicode calls with inline code for fast 
indirect calls. 

• 64-bit integral data types (long long and unsigned long long) are 
supported for HP aC-H-applications needing large integers, such as 
large file system databases. Use the-ext command line option to 
specify. 


Chapter 1 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


• HP aC-H- features are supported by the HP Distributed Debugging 
Environment (DDE). 

• The -Fhelp option invokes online help for the H P aC++ compiler and 
linker and libraries. 


Migrating from HP C++(cfront) to HP 
aC++ 

The compiler lists Errors, Future Errors and Warnings. Expect to see 
more warnings, errors and future errors reported in your code, many 
related to standards based syntax. For more complete information, refer 
to: 

1. H P aC-H-T ransition Guide at the following world wide web URL: 

http://www.hp.com/go/hpc++/ 

The HP aC-H-Online Programmer's Guide section Migrating from HP 
C-H-(cfront) to H P aC++contains a subset of the information found in 
the transition guide. 

2. For general background information and experience, subscribe to the 
cxx-dev list server (like a notes group). Send a message to 
majordomo@cxx.cup.hp.com with the following command in the 
body of the message: subscribe list-name 

Available list-names are as follows: 

cxx-dev HP C++ Development Discussion List 

cxx-dev-announce HP C++ Development Announcements 

cxx-dev-digest HP C++ Development Discussion List Digest 

cxx-dev-announce is also broadcast to cxx-dev, so there is only a need 
to subscribe to one of the lists. The digest also includes both cxx-dev 
and cxx-dev-announce. 

For additional help or information about the list server, send a 
messageto majordomo@cxx.cup.hp.com with the following command 
i n the body of the message: hel p 

3. For specific support questions, contact your H P support 
representative. 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 


4. For generic C++questions, see documents and URL's listed in the H P 
aC++OnlineProgrammer'sGuidq Information Map. 

Some migration issues are listed below: 

• The overload resolution for operators has been updated to reflect the 
latest version of the evolving draft standard. You may see some 
additional "ambiguous" function error messages displayed. 

• Most frequently reported migration issue: enum x {xl, }; The trailing 
comma is an error. 

• Changes to temporary creation for rvalues used to initialize return 
values which are const references now causes: 

Error 652: Exact position unknown; near file, line#. 
Initialization of the result <some const &> requires creating a 
temporary, yet the temporary's lifetime ends with the return 
from the function. 

• You can bracket your H P aC++changes with the macro defined by the 
draft standard. For example: 

#if _cplusplus >= 199707L 

// HP aC++ Code 

#endif // _cplusplus >= 199707L 

• If you are using directed mode instantiation with the cfront based 
compiler, an awk script can be used to convert your file to an 
instantiation file that uses the explicit instantiation syntax. Note 
that explicit instantiation syntax can be used to instantiate a 
template and all of its member functions, an individual template 
function, or a tempi ate cl ass's member function. The H P aC++Online 
Programmer's Guidecontains an example script. 


Chapter 1 
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Features 

Migrating from HP C++ (cfront) to HP aC++ 
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Installation Information 

Patch Installation Requirements 


I nstal I ati on I nformati on 


Read this entire document and any other release notes or readme files 
you may have before you begin an installation. 

To install your software, run the SD-UX swinstall command. It will 
invoke a user interface that will lead you through the installation. For 
more information about installation procedures and related issues, refer 
toManaging FIP-UX Softwarewith SD-UX and other README, 
installation, and upgrade documentation provided or described in your 
H P-UX 10.x operating system package. 

Depending on your environment, you may also need documentation for 
other parts of your system, such as networking, system security, and 
windowing. 

H P aC-H-requires approximately 80 MB of disk space: 28 MB for the files 
in /opt/aCC and 50 MB for DDE, Blink Link, HP/PAK, and WDB. 


Patch Installation Requirements 

Patch id When to install 

PHKL_8693 - If the sys/time.h header file is used (series 700). 

PHKL_8694 - If the sys/time.h header file is used (series 800). 

PHSS_13124 - If any of the debug (-g) options are used. 

PHCO_14645 - If libc header files are used. 

I n addition, it is recommended that you install the core patches 
distributed on the extension software media. 


Chapter 2 
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Installation Information 

Current Run-time Support Library Required 


Current Run-time Support Library 
Required 

To work correctly, an application must be linked to or run with an HP 
aC-H-run-time support library (libCsup.a or libCsup.sl) that comes with 
this version of H P aC-H-or a subsequent version. Linking with an older 
version of libCsup.a or running your application with an older version of 
libCsup.sl (the default) may cause spurious failures. 


Attention Softbench Users 

You should install Softbench (DDE and PAK) before installing H P aC++. 
This is because HP aC-H-is packaged with DDE and a DDE specific 
patch. Not installing in this order results in an unsupported 
configuration. 
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Related Documentation 

Online Documentation 


Related Documentation 


Documentation for HP a C++ is described in the foil owing sections. 


Online Documentation 

The following online documentation is included with theHP aC++ 
product. 

HP aC-H-Online Programmer's Guide 

Access the guide in any of the foil owing ways: 

• Use the+help command-line option. (Be sure/opt/aCC/bin/ is in your 
path.) 

aCC +help 

• F rom your web browser menu bar, use the left mouse button to choose 
File and Open File. Enter the foil owing file name: 

/opt/aCC/html/C/guide/index.htm 

All of the files composing the guide areinstalled in the/opt/aCC/html/ 
directory. If you choose to move the entire guiden to a different location 
without havi ng to edit any I i nks, you wi 11 need to move al I of the 
subdirectories in /opt/aCC/html. 

• The guide is also available on the World Wide Web at the foil owing 
URL: 

http://docs.hp.com/hpux/development/ 


Chapter 3 
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Related Documentation 

Online Documentation 


Using Templates in HPaC++ 

This technical document summarizes template features defined in the 
proposed C++standard and describes template instantiation as 
implemented in HP aC++. It isprovided with HP aC++in both postscript 
and HTML format in the foil owing locations: 

/opt/aC C/newconfi g/T ecD ocs/templ ates. ps 

/opt/aC C/newconfi g/TecD ocs/templ ates. ht m 


NOTE You can select the HTML version from the initial window of the H P aC++ 

Online Programmer's Guide. 


HP-UX Linker and Libraries Online User 
Guide 

This Guide may not be installed on pre-H P-UX 10.20 systems. I n this 
case, refer tothe later section in this chapter, Linker Compatibility 
Warnings, for valuable information. 

To access, use the linker command with the +help option. (Be sure 
usr/ccs/bin/ is in your path.) 

Id +help 

HP DDE Debugger OnlineHelp 

Select help from the DDE Menu Bar.: 

HP Vtfldebeest Debugger (HP WDB) 

All of the H P WDB documentation is available online at the following 
World Wide Web directory: 

http://www.hp.com/go/languages 

Select "H P Debuggers" to learn about WDB, or download the product and 
documentation. 
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Related Documentation 

Online Documentation 


Rogue Vtave Software Standard C++Library 
1.2.1 Class Reference 

This reference provides an alphabetical listing of all of the classes, 
algorithms, and function objects in the Rogue Wave implementation of 
the Standard C++Library. It is provided as HTML formatted files. You 
can view these files if you have access to an HTM L viewer such as 
Netscape. To do so, open thefile/opt/aCC/html/libstd/ref.htm 

Rogue Wave Software Tool s.h++ 7.0.6 Class 
Reference 

This reference describes all of the classes and functions in theTools.h++ 
Library. It is provided as HTML formatted files. You can view these files 
if you have access to an HTML viewer such as Netscape. Todoso, open 
the file/opt/aCC/html/librwtool/ref.htm 


NOTE Refer to the I nformation Map in the HP aC++Online Programmer's 

Guidefor how to obtain additional Rogue Wave documentation and 
information. 

HP a C++ Release Notes 

This is the document you are reading. The online ASCI I file can be found 
in /opt/aCC/newconfig/RelNotes/ACXX.release.notes 

HP PA-RISC Compiler Optimization 
Tech nol ogy Wh i te Pa per 

This paper describes the benefits of using optimization. It is available in 
the postscript file/opt/langtools/newconfig/white_papers/optimize.ps 

Online Manual Pages 

Online manual pages for aCC and c++filt are at 
/opt/aCC/share/man/manl.Z. 

Manual pages for the Standard C++Library and thecfront compatibility 
libraries (I OStream and Standard Components) are provided under 
/opt/aCC/share/man/man3.Z. (Notefor Standard Components only, 
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Related Documentation 

Printed Documentation 


invoke a man page by entering 3s after the man command and before the 
man page name. For example, to invoke the man page for Args: man 3s 
Args) 

J apanese man pages are located at: 

/opt/aCC/share/man/ja_JP.eucJP/manl.z and 

/opt/aCC/share/man/ja_JP.eucJP/man3.z (euc character set) 

/opt/aCC/share/man/ja_JP.SJIS/manl.z and 

/opt/aCC/share/man/ja_JP.SJIS/man3.z (SJIS character set) 


Online C++Example Source Files 

Online C++example source files are located in the directory, 
/opt/aCC/contrib/Examples/RogueWave. These include examples for the 
Standard C++Library and for theTools.h++Library. 


Printed Documentation 

• H P aC++Release Notes is this document. A printed copy of the 
release notes is provided with the H P aC++ product. 

Release notes are also provided online, as noted above. 


Other Documentation 

Refer to the H P aC++Online Programmer's Guide I nformation Map for 
documentation listings, URL's, and course information related tothe 
C++ language. Also, see below. 

The foil owing documentation is available for use with FI P aC++. To order 
printed versions of Hewlett-Packard documents, refer to manuals(5). 

• HP/ DDE Debugger User's Guide contains information on debugging 
C++programs with theHP Distributed Debugging Environment on 
the H P 9000. 
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Related Documentation 

Other Documentation 


• Getting Started with SoftBench on H P-UX 10.x contains SoftBench 
tutorials for C, C++, and COBOL. 

• C and C++SoftBench User's Guide for HP-UX 10.x contains 
information on using C and C++Soft Bench. 

• I nstalling and Customizing SoftBench Products contains installation 
and customization information for SoftBench Products on HP-UX 9.x, 
H P-UX 10.x and Solaris. 

Content of .o Files may Change 

The foil owing applies when you use an aCC command-line option that 
invokes the assigner. 

The content of a given ,ofile can potentially change when it is used in a 
closure (with the +inst_closeoption) or link operation. The change may 
occur in either of the foil owing cases: 

• You change the order of .o file's on thelink line. For example, if you 
compile and link A.c and B.c multi pie times as follows, the contents of 
A.oand B.o may not be the same foil owing the second link as they 
were foil owing the first link: 

aCC -c A.c B.c 
aCC A.o B.o 

aCC -c A.c B.c 
aCC B.o A.o 

• You link a .ofilewith different objects. In the foil owing example, the 
content of A.o may not be the same foil owing the second link as it was 
foil owing the first link: 

aCC A.o B.o 
aCC A.o C.o 

The Named Return Value (NRV) Optimization 

Syntax: -Wc,-nrv_optimization,[off|on] 

The above syntax disables (default) or enables the named return value 
(NRV) optimization. For this optimization to work correctly in 
conjunction with exception handling, the application must be linked to 
an aC++ run-time support library that comes with H P aC++A.01.04 or a 
subsequent version. Linking with a prior library may cause spurious 
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Related Documentation 

Other Documentation 


failures. If the shared version of this library is selected (default), the 
platform on which the application is run must also have that release of 
the HP aC++ run-time support library (libCsup.sl). 

The NRV optimization eliminates a copy-constructor call by allocating a 
local object of a function directly in the caller's context if that object is 
always returned by the function. For example: 

struct A { 

A(A constS); // copy-constructor 

}; 

A f(A constS x) { 

A a(x); 

return a; // Will not call the copy constructor if the 
} // optimization is enabled. 

This optimization will not be performed if the copy-constructor was not 
declared by the programmer. Note that although this optimization is 
allowed by the ISO/ANSI C++working paper, it may have noticeable 
side-effects. 

Example: aCC -Wc,-nrv_optimization,on app.C 

Linker Compatibility Vfernings 

Beginning with the H P-UX 10.20 release, the linker generates 
compatibility warnings. These warnings include H P 9000 architecture 
issues, as well as linker features that may change over time. 

Compati bi I ity warni ngs can be turned off with the 
+v[no]compatwarnings linker option. Also, detailed warnings can be 
turned on with the +vallcompatwarnings linker option. 

Link time compatibility warnings include the foil owing: 

• Linking PA-RI SC 2.0 object files on any system — PA-RI SC 1.0 
programs will run on 1.1 and 2.0 systems. PA-RI SC 2.0 programs will 
not run on 1.1 or 1.0 systems. 

• Dynamic linking with -A — If you do dynamic linking with -A, you 
should migrate to using the Shared Library Management Routines. 
These routines are also described in thesh_load(3X) man page. 

• Procedure call parameter and return type checking (which can be 
specified with -C) — The current linker checks the number of 
symbols, parameters, and procedure calls across object files. I n a 
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Related Documentation 

Other Documentation 


future release, you should expect H P compilers to perform 
cross-module type checking, instead of the linker. This impacts H P 
Pascal and HP Fortran programs. 

• Duplicate names found for code and data symbols — The current 
linker can create a program that has a code and data symbol with the 
same name. I n a future H P-UX release, the linker will adopt a single 
name space for all symbols. This means that code and data symbols 
cannot share the same name. Renaming the conflicting symbols 
solves this problem. 

• Unsatisfied symbols found when linking to archive libraries — If you 
specify the-v option with the +vallcompatwarnings option and link to 
archive libraries, you may see new warnings. 

• Versioning within a shared library — If you do versioning within a 
shared library with theHP_SHLIB_VERSION (C and C++) or the 
SH LI B_VERSI ON (Fortran and Pascal) compiler directive, you 
should mi grate to the industry standard and faster performing 
library-level versioning. 
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Other Documentation 
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Problem Descriptions and Fixes and Known Limitations 

Known Problems 


Problem Descriptions and Fixes 
and Known Limitations 


This chapter summarizes the known problems and limitations of the 
current version of H P aC++except as otherwise noted. 

HP-UX 10.10 is the last supported OS for PA-RI SC 1.0 architecture 
machines. H P-UX 10.20 no longer supports execution of PA-RI SC 1.0 
code, and 10.20 compilers no longer support the compilation of PA-RI SC 
1.0 code. 

Seethe latest HP-UX Software Status Bulletin support document for 
other known problems. 


Known Problems 

Customers on support can use the product number to assist them in 
finding SSB and SRB reports for H P aC++. The product number you can 
search for is B3910BA. 

To verify the product number and version for your HP aC-H-compiler, 
execute the fol I owi ng H P-U X commands: 

what /opt/aCC/lbin/ctcom 
what /opt/aCC/bin/aCC 

To verify the product number and version for the linker: 

what /opt/aCC/lbin/ld 

To verify the product number and version for the shared library 
initializer: 

what /usr/lib/aCC/dld.si 

Following are known problems and workarounds. 
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Incompatibilities Between the Standard C++ 
Library and the Draft Standard 

As the ANSI C++draft standard has evolved over time, the Standard 
C++Library has not always kept up. Such is the case for the "times" 
function object in the functional header file. I n the standard, "times" has 
been renamed to "multiplies." 

If you want to use "multiplies" in your code, to be compatible with the 
ANSI C++draft standard, use a conditional compilation flag on theaCC 
command line. 

For example, for the following program, compile with the command line: 
aCC -D_H PACC_USI NG_M U LTI PLI ES_l N_FU NCTI ON AL test.c 

// test.c 

int times; //user defined variable 

#include <functional> 

// multiplies can be used in 


int main() {} 

// end of test.c 

Depending on the existence of the conditional compilation flag, 
functional defines either "times", or "multiplies", not both. 

So, if you have old source that uses "times" in header functional and also 
new source that uses "multiplies", the sources cannot be mixed. Mixing 
the two sources would constitutea non-conforming program, and the old 
and new sources may or may not link. 

If your code uses the old name "times," and you want to continue to use 
the now non-standard "times" function object, you do not need to do 
anything tocompiletheold source. 

Unsatisfied Symbols if Using Non-current 
Run-time Support Library 

If you see a message I ike the foil owing, you may be using a non-current 
version of the HP aC++run-time support library. 

/opt/aCC/lbin/ld: Unsatisfied symbols: 

Class tables [Vtable] dependent on key function: 

"_versioned_type_info::~_versioned_type_info ()" (data) 
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For example, if you area library distributor, you must ensure that your 
customers use the same or a newer version of the libCsup run-time 
library as you. If necessary, you should install the most current H P 
aC-H-library support patch and distribute this patch to your customers. 

As of the date of these release notes, the most current library support 
patch number is: PHSS_15043 

Unsatisfied Symbols for Inline Template 
Functions 

If you use explicit instantiation instead of closing a library, and you 
compile with the +inst_auto option, then unsatisfied symbols will be 
generated for inline template functions that aretoo large to inline. 

Syntax Errors when Using 
/usr/i ncl ude/sys/ti me.h 

If you see the following error message, it means that 
CLOCKS_PER_SEC is not defined: 

Error 171: ”7198.C", line 2 # Undeclared variable 
'CLOCKS_PER_SEC'. int i = CLOCKS_PER_SEC; 


The workaround is to modify the/usr/i ncl ude/sys/ti me.h file as follows: 

1. Find the first occurence of: 

#endif /* _INCLUDE_STDC_ */ 

2. I mmediately before the first occurence of the above I i ne, add the 
following code, replacing SomeValue with the value you need 
(1000000 would be the system default): 

#else 

#ifdef _cplusplus 

fdefine CLOCKS.PER_SEC SomeValue 
#endif 

The/usr/i ncl ude/sys/ti me.h filecontains a K & R stylefunction 
declaration for which H P aC-H-generates an error I ike the foil owing: 

Error 43: "/usr/include/sys/time.h ", line 487 # C++ does not allow 
Old-style (non-prototype) function definitions. 
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To workaround, whenever time.h is included by a source program, you 

can define the_STDC_macro on your command-line, as in the 

following example: 

aCC -D_STDC_ 

Or you can install the appropriate patch listed below: 

PHKL_8691 series 700 HP-UX 10.10 

PHKL_8692 series 800 


PHKL_8693 series 700 HP-UX 10.20 

PHKL_8694 series 800 


HP aC-H-generatres an error like the foil owing stating that structs or 
any types cannot be declared extern. 

Error 608: "/usr/include/sys/time.h", line ??? # Types may not be 
declared static, auto, register, extern or mutable, 
extern struct sigevent; 


The error is caused by a problem in the/usr/i ncl ude/sys/time.h file. To 
workaround, you can change the line extern struct sigevent; in the 
time.h file to: 

struct sigevent; 

Or you can install the appropriate patch listed below: 

PHKL_7962 series 700 HP-UX 10.20 

PHKL_7963 series 800 

Syntax Problems when Using 
/usr/i ncl u d e/mat h.h 

To resolve a conflict between the exception struct in 

/usr/include/sys/math.h and the aC-H-exception struct, the workaround 

is to modify the /usr/i ncl ude/math.h file as follows: 

1. Find the line: 

fdefine _MATH_INCLUDED 

2. I mmediately following the above line, add the next line: 

#define exception math_exception 

3. Find the line: 

#endif /* _MATH_INCLUDED */ 

4. I mmediately before the above line, add this line: 
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#undef exception 

Alternatively, you can install thePHCO_9261 patch. 

Warnings when using /usr/include/rpc/xdr.h 

Compile-time warnings I ike the foil owing should be ignored. They are 
caused by an incorrect prototype in the/usr/include/rpcyxdr.h file. 

Warning 301: "/YourFileName/usr/include/rpc/xdr.h", line 276 # The 
(...) parameter list is a non-portable feature. 

extern bool_t xdrrec_eof(_o); /* true iff no more input */ 

Binary Compatibility 

An application that ran on previous HP-UX 10.x releases (10.01, 10.10, 
or 10.20) will generally continue to run with the same behavior with this 
10.20-based H P aC-H- release provided that any dependent shared 
libraries are also present. An executable is a binary file that has been 
processed by the H P linker with Id or indirectly with the compiler, and 
can be run by the H P-UX loader(exec). 

The foil owing items describe exceptions to binary compatibility between 
the previous 10.20 and current releases. These conditions can occur 
during your development process, but rarely affect deployed applications. 

Binary Incompatibilities without Changes 

Under the following conditions, when you compileyour source code 
without any changes (to source code, options, or makefiles), you can 
create relocatable object files or executables that cannot be moved back 
to a previous 10.x system. 

• Instrumented code with PBO or +04 optimization 

If you use PBO (-H compiler or linker option) or the +04 option during 
development and recompile with your current compiler, you may 
create instrumented objects (I SOM) that a previous system does not 
recognize. 


NOTE This code may not be backward-compatible with previous 10.x releases. 

In general, you cannot move instrumented object files backward. 


If you move an I SOM across operating system versions, for example, 
from an 11.x system to a 10.x system, you may receive the following 
error: 
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Error at line 0: Backend Assert ** Ucode versions earlier then 
v.4 no longer supported. (5172) 

Binary Incompatibilities with Changes 

When you make changes to your source code, options, or makefiles to use 
new features of the current release, you can introduce the foil owing area 
of binary incompatibility. 

• Open Graphics Library (OGL) Support 

This release provides OGL support to improve performance. If you 
make changes to your source code to recompile usi ng the OGL 
headers, you receive the message "invalid fixup" when you link your 
relocatable object file or run your executable on a previous 10.x 
system. . 


Known Limitations 

Some of these limitations will be removed in future releases of H P aC++. 

Please be aware that some of these limitations are platform-specific. 

• The-Wc,-koenig_lookup,on option enables argument-dependent name 
lookup, but currently fails for function calls with explicit 
template-arguments. For example: f<X>(a); // Compiler fails if 
-Wc,-koenig_lookup,on 

• H P aC-H-does not support the xdb debugger. I nstead, use the H P 
WDB Debugger available on the World Wide Web (see Chapter 3 of 
these release notes for the U RL). Or use the H P/DDE Debugger 
supplied with the product. 

• HP aC++does not and will not in the future support installation 
and/or execution on H P-UX 9.x systems. 

• HP aC++does not support large files (i.e., greater than 2 GB) with 
<iostream.h>. 

• Notethat although the compiler will run on the PA Rl SC 1.0 
architecture, an H P aC-H-executable will run only on the PA Rl SC 
1.1 or later architecture. 

• Known limitations of exception handling features: 
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• I interoperability with setjmp/longjmp (undefined by the C++draft 
proposed international standard) is unimplemented. Executing 
longjmp does not cause any destructors to be run. 

• If an unhandled exception is thrown during program initialization 
phase (that is, before the main program begins execution) 
destructors for some constructed objects may not be run. 

• Symbolic debugging information is not always emitted for objects 
which are not directly referenced. For instance, if a pointer to an 
object is used but no fields are ever referenced, then H P aC++only 
emits symbolic debug information for the pointer type and not for 
the type of object that the pointer points to. For instance, use of 
Widget * only emits debug information for the pointer type 
Widget * and not for Widget. If you wish such information, you can 
create an extra source file which defines a dummy function that 
has a parameter of that type (Widget) and link it into the 
executable program. 

• Known limitations of signal handling features: 

• Throwing an exception in a signal handler is not supported, since 
a signal can occur anyplace, including optimized regions of code 
in which the values of destructableobjects are temporarily held in 
registers. Exception handling depends on destructableobjects 
being up-to-date in memory, but this condition is only guaranteed 
at call sites. 

• Issuing a longjmp in a signal handler is not recommended for 
the same reason that throwing an exception is not supported. 

The signal handler interrupts processing of the code resulting 
in undefined data structures with unpredictable results. 

• Source-level debugging of C-H-shared libraries is supported. 
Flowever, there are limitations related to debugging C-H-shared 
libraries, generally associated with classes whose member functions 
are declared in a shared library, and that have objects declared 
outside the shared library wherethe class is defined. Refer to the 
appropriate release notes and manuals for the operating system and 
debugger you are using. 

Refer also to the Software Status Bulletin for additional details. 

• I nstantiation of shared objects in shared memory is not supported. 
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• When you call the <shl_load>(3) routines in libdld.sl either directly or 
indirectly (as when your application calls use the +A option, you will 
get an "unresolved externals" error. 

If you want to link archive libraries and libdld.sl, usethe-WI,-a, 
archive option. The foil owing example directs the linker to use the 
archive version of standard libraries and (by default) libdld.sl. 

aCC prog.o -Wl,-a,archive 

• Using shl_load(3X) with Library-Level Versioning 

Once library-level versioning is used, calls to shl_load() (see 
shl_load(3X)) should specify the actual version of the library that is to 
be loaded. For example, if libA.sl is now a symbolic link to libA.l, then 
calls to dynamically load this library should specify the latest version 
available when the application is compiled, such as: 

shl_load("libA.1", BIND_DEFERRED, 0); 

This will insure that, when the application is migrated to a system 
that has a later version of I ibA available, the actual version desired is 
the one that is dynamically loaded. 

• Memory Allocation Routine allocaO 

The compiler supports the built in function, alloca, defined in the 
/usr/include/alloca.h header file. The implementation of the allocaO 
routine is system dependent, and its use is not encouraged. 

allocaO is a memory allocation routine similar to mallocO (see 
malloc(3C)). The syntax is: 

void *alloca(size_t <size>); 

allocaO allocates space from the stack of the caller for a block of at 
least <size> bytes, but does not initialize the space. The space is 
automatically freed when the cal ling routine exits. 


NOTE Memory returned by allocaO is not related to memory allocated by other 

memory allocation functions. Behavior of addresses returned by allocaO 
as parameters to other memory functions is undefined. 


To use this function, you can use the <al I oca. h> header file. 
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